home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / news / readers / slnr / README < prev    next >
Encoding:
Text File  |  1993-08-11  |  4.1 KB  |  120 lines
  1. README FILE
  2. Version : 1.6
  3.  
  4. What is SLNR ?
  5. ~~~~~~~~~~~~~~
  6. The SLNR package is an off-line usenet news reader : it is intended for users
  7. who want to connect to a host, download a packet with new messages, read
  8. them on their home machine and upload the replies later.
  9.  
  10. Slnr stands for "Simple Local News Reader" 
  11.  
  12. The slnr package contains the following files
  13.  
  14. - getnews.c : This program runs on your unix machine and get all unread 
  15. articles in all subscribed newsgroups as well as your new mail and creates a 
  16. packet (.zip, .arc, .zoo) that you can download and view with slnr.
  17.  
  18. - slnr.c : The offline news reader which runs on your local machine and let 
  19. you view and reply to messages. So far there is a Unix, Dos and Atari 
  20. version.
  21.  
  22. - postreply.c : Like getnews this program runs on unix machine and post mail
  23. and news articles from the reply packet.
  24.  
  25. - colour.h : needed in slnr.c
  26.  
  27. - sig.txt  : optional signature to be appended at the end of your messages
  28.  
  29. - slnp.fmt : The packet format
  30.  
  31. - slnr.doc : First try at a documentation
  32.  
  33.  
  34. What are my objectives ?
  35. ~~~~~~~~~~~~~~~~~~~~~~~~
  36.   - The specification for the format and the sources of getnews and slnr 
  37.   will be widely available and in the public domain. (unlike QWK where the 
  38.   format is cryptic).
  39.   
  40.   - There wont be any restriction for people who want to make shareware or 
  41.   commercial version of the software. 
  42.   
  43.   - There will be a "version" scheme : The packet format should stay the 
  44.   same but even if it has to be altered the version will be noted in the 
  45.   packet so future readers can extract information properly.
  46.   
  47.   - Development on multiple platforms will be encouraged (specially Mac and 
  48.   Amigas where I don't have access). However I will keep the master source 
  49.   and will decide how to integrate the updates and bug fixes I receive.
  50.   
  51.   - I will also encourage translations of the doc and the user interface (I 
  52.   can work on the french version though :-) ).
  53.   
  54.  
  55. Where to go from there ?
  56. ~~~~~~~~~~~~~~~~~~~~~~~~
  57.    
  58.    - Compile and test the product on your machine (you don't really need a
  59.    makefile but feel free to write one if it helps).
  60.  
  61.    On the unix machine : compile getnews.c and postreply.c. You may have to
  62.    modify them for your system. Read the getnews.doc documentation and
  63.    create a .getnewsrc config file to suit your needs.
  64.  
  65.    On the dos/atari/etc... machine : Compile slnr.c, maybe create a "batch"
  66.    program to extract the files from the packet.
  67.  
  68.    - Send comments or bug report to me <pgoujard@infocom.co.uk>
  69.  
  70.    - If you are interested in SLNR and other off-line news reader, 
  71.    read the usenet newsgroup : alt.usenet.offline-reader
  72.  
  73.  
  74. Changes since the previous issues
  75. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  76.  
  77. - 23/05/93 : Start of slnr v2.0. Adding "#ifdef __STDC__" to cope with non
  78. ansi compilers.
  79.  
  80. - SLNR : Fixing the mail/posting bug: creation of a special area
  81. RMAIL.MSG which contains all replies by mail.
  82.  
  83. - SLNR : Accepting files which are at the mail or MMDF format. 
  84.  
  85. - SLNR : Add the "LINES" entry in the config file (however on a dos machine 
  86. it does not put the machine in that line mode, it just tells SLNR that
  87. there are more lines to use).
  88.  
  89. - SLNR : Change the #ifdef DOS to #ifdef __MSDOS__
  90.  
  91. - Getnews : Print a "." only every 10 articles.
  92.  
  93. - Getnews : If Delete_mailbox is unset, save the content of the mailbox to
  94. the $HOME/.oldmail file
  95.  
  96. - Getnews : Fix a bug that was allowing to close stderr.
  97.  
  98. - Getnews : Change the way the compression utility is used. The config file
  99. has to have an entry called "compress=" pointing to the program doing the
  100. compression and packing. By default /usr/local/bin/zip is used.
  101.  
  102. - Getnews : Add support for a configuration file + creation of getnews.doc
  103.  
  104. - SLNR : support the "quote" entry in the config file
  105.  
  106. - SLNR : Allow header editing for replies.
  107.  
  108. - SLNR : Add the "so.and.so wrote:" line in top of follow-ups
  109.  
  110. - SLNR : Add 's' and 'S' command to save an article to a file
  111.  
  112. - SLNR : Add '!' command to execute a shell program.
  113.  
  114. Thanks to
  115. ~~~~~~~~~
  116.        - Bob Rusbasan <rrusbassa@nyx.cs.du.edu> for carrying on intensive 
  117.        tests on the dos version of SLNR and for his overall support.
  118.  
  119.        - Dick Grady <grady@world.std.com> for helping with getnews.c
  120.